home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr30 / shwsci10.zip / SHOWSCI.DOC < prev    next >
Text File  |  1992-12-30  |  6KB  |  150 lines
  1. SHOWSCI 1.0  -  Displays Colorix SCI files in 320x200x256 mode
  2. Copyright (c) 1992, Matthew J. Slattery
  3.  
  4.  
  5.  
  6. PURPOSE
  7. =======
  8.     SHOWSCI is a little program I wrote to liven up my AUTOEXEC batch file.
  9.     It scrolls a Colorix .SCI file (explained below) from the bottom of
  10.     the screen, then scrolls it off the screen. This permits display
  11.     of a picture while your autoexec cranks away, loading drivers, etc.
  12.  
  13.  
  14.  
  15. USAGE
  16. =====
  17.      SHOWSCI  operators  filename
  18.  
  19.     Valid Operators:
  20.         in     -  Scroll picture up from bottom, stay in VGA mode
  21.         out    -  Scroll displayed picture down, reset to text mode
  22.         pause  -  Display picture, wait for keystroke, reset to text mode
  23.  
  24.  
  25.  
  26. EXAMPLE
  27. =======
  28.     The following example shows how to display a .SCI file at the
  29.     beginning of an AUTOEXEC.BAT, and how to clear it at the end of
  30.     the batch file:
  31.  
  32.         REM Display a .SCI file
  33.         showsci in mjs.sci
  34.  
  35.         REM Do everything else
  36.         C:\windows\smartdrv >NUL:
  37.         C:\dos\doskey       >NUL:
  38.     
  39.         REM Clear the picture
  40.         showsci out
  41.  
  42.     Note that you have to add  ">NUL:" to any line between the "showsci in"
  43.     and the "showsci out". If you don't, these programs will write to the
  44.     screen, and you will see garbage displayed on your picture.  Error
  45.     messages from executing programs will also mess up your picture.
  46.  
  47.  
  48.  
  49. .SCI FILES
  50. ==========
  51.     The .SCI file format comes from a paint program called COLORIX.  It
  52.     is primarily a SuperVGA program, but also allows you to create files
  53.     in the standard 320x200x256 VGA mode.  These files have the extension
  54.     "SCI".
  55.  
  56.     The .SCI file format is very straight-forward, and, hopefully, you will
  57.     have little trouble creating these if you do not own COLORIX.  The file
  58.     format is as follows:
  59.  
  60.  
  61.         What            Bytes   Description
  62.         -----------     -----   -----------
  63.         Header          10      4 bytes - "RIX3"
  64.                                 2 bytes - 40 01 - screen width (320)
  65.                                 2 bytes - c8 00 - screen height (200)
  66.                                 2 bytes - af 00 - 175, don't know why
  67.                                 SHOWSCI doesn't check for a valid header,
  68.                                 so you can put any 10 bytes you wish here.
  69.  
  70.         Palette         768     256 groups of 3 RGB bytes. Each group
  71.                                 defines the red, green and blue values
  72.                                 (each ranging from 0-63) for each of 256
  73.                                 available colors.
  74.  
  75.         Picture Data    64,000  200 lines of 320 bytes each, where each
  76.                                 byte represents one of the 256 available
  77.                                 colors.
  78.  
  79.  
  80.  
  81. GIF2SCI.EXE
  82. ===========
  83.     GIF2SCI is a utility to convert graphics files in the Compuserve GIF
  84.     format to Colorix's SCI format.  To convert a file, run GIF2SCI,
  85.     passing the name of a GIF file.  You may also pass it an output
  86.     filename, if you wish.  If you don't pass an output file, a SCI
  87.     file will be created with the same name as the GIF file, but with
  88.     the extension SCI. Some examples are shown below:
  89.  
  90.         GIF2SCI  test   -   Reads TEST.GIF, writes TEST.SCI
  91.         GIF2SCI  in out -   Reads IN.GIF, writes OUT.SCI
  92.         GIF2SCI         -   Displays help screen.
  93.  
  94.     The utility will display the GIF file and write it to the SCI file.
  95.     Hit any key to exit.
  96.  
  97.  
  98.  
  99. COMPATIBILITY
  100. =============
  101.     SHOWSCI forces your VGA card into a non-standard 320x200 mode to
  102.     accommodate smooth scrolling.  It should work with any card that
  103.     is register-compatible with IBM's VGA standard.  I have seen the
  104.     program balk on one type of VGA card, displaying four quarter-screen
  105.     copies of the desired screen.  Please let me know if you have any
  106.     problems.
  107.  
  108.     I also use this program to liven up my login script on a Novell network.
  109.     There are no problems doing this directly on the network, but I
  110.     sometimes call in over modems using a remote-control program. It is
  111.     advisable that your login script recognize whether you're dialing in,
  112.     and to not execute SHOWSCI if you are. Otherwise, your remote-control
  113.     program will have to send a lot of graphics data over the phone, taking
  114.     about 10 minutes at 2400-baud.
  115.  
  116.  
  117.  
  118. DISTRIBUTION POLICY
  119. ===================
  120.     This is FREEWARE. There is no registration required, and no "donation"
  121.     needed to use this program.  Distribute it freely.  It may be used
  122.     in a corporate environment without compensation or penalty.
  123.  
  124.     No alterations may be made to the original program, or included files.
  125.     No additional files may be distributed with this program, and none
  126.     of the original files may be excluded from distribution, without
  127.     express written consent from the author.
  128.  
  129.     I make no warranty for this program, and may not be held liable for
  130.     damages or lost profits, incidental or consequential to use of this
  131.     program.
  132.  
  133.     Use of this software implies agreement to the above terms.
  134.  
  135.  
  136.  
  137. CONTACT ADDRESS
  138. ===============
  139.     I am interested in your comments and suggestions, and will try
  140.     to solve any problems. If you wish to contact me, you may write me
  141.     at the following address.  Please let me know which version of SHOWSCI
  142.     you have, and what brand VGA card is in your computer.  Thanks.
  143.  
  144.         Matthew J. Slattery
  145.         re: SHOWSCI
  146.         1698 Forest Hill Court
  147.         Crofton, MD 21114
  148.  
  149.     ENJOY!
  150.